home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / rastms34.zip / RM.DOC < prev    next >
Text File  |  1993-01-27  |  12KB  |  340 lines
  1.                        Raster Master V3.4
  2.  
  3.           (c) Copyright 1991-93 by Scarborough Digital.
  4.                       All Rights Reserved. 
  5.  
  6.  
  7.  
  8.  
  9.  
  10. INTRODUCTION
  11.  
  12.   Raster Master is a powerful graphic editor that allows
  13. programmers and developers to create and manipulate small images.
  14. Raster Master can edit images from 1X1 pixel up to 100X100
  15. pixels. Images can be saved in standard PCX format or as source
  16. code making it easy to add to your programs.  Raster Master was
  17. designed to work in conjunction with other toolkits and graphic
  18. libraries such as Fastgraph and TEGL Windows Toolkit as well as
  19. the standard graphic libraries for Turbo C, QuickC, Turbo Pascal,
  20. and QuickBasic.  Additional BMP and ICO formats are supported for
  21. Windows 3.
  22.  
  23.  
  24. REQUIREMENTS
  25.  
  26.   VGA Card, SVGA optional for the 256 color mode
  27.   Mouse
  28.   DOS 3.0 or higher
  29.  
  30.  
  31. USING THE EDITOR
  32.  
  33. OPEN/SAVE:  Click in the FILENAME area and type in the name.
  34.  
  35. Any FILE in the FILE LISTING can be selected by simply pointing
  36. to it.
  37.  
  38. DIRECTORIES can be accessed in one of two ways.  Either by
  39. changing the contents of the DIRECTORY area or pointing to the
  40. actual directory in the listing.
  41.  
  42. CHANGING THE OPEN FORMAT: Press the RIGHT mouse button over the
  43. OPEN gadget. 
  44.  
  45. CHANGING THE SAVE FORMAT: Press the RIGHT mouse button over the
  46. SAVE gadget.
  47.  
  48. Use the up and down gadgets to select the new format.
  49.  
  50.  
  51.  
  52.  CLR       Clears the screen.
  53.  
  54.  UNDO      Deletes last step taken.
  55.  
  56.  GRID      Toggles the grid ON/OFF.
  57.  
  58.  SIZE      Allows you to select the size of the zoom area.
  59.            25x25, 50x50, 100x100 pixels are supported.  The
  60.            scrollers can be used to move to different areas
  61.            of the image when in the 25x25 or 50x50 zoom mode.
  62.  
  63.  VIEW      Previews  drawing in one of the listed resolutions.
  64.  
  65.  MODE      Toggles between 16 and 256 color mode.
  66.            Note: ONLY registered users will be given the
  67.            opportunity to save their images in the 256
  68.            color mode.
  69.  
  70.  EXIT      Exits Raster Master.
  71.  
  72.  CLIP      Switches to clip mode allowing you perform the        
  73.            following functions.
  74.  
  75.            OPEN/SAVE: Works the same way as the OPEN/SAVE
  76.                       described above.  When OPENing/Saving,
  77.                       only the clipped area will be affected.
  78.  
  79.            HFLIP/VFLIP: Horizontally/vertically flips the
  80.                         clipped image.
  81.  
  82.            LEFT/RIGHT/UP/DOWN:  Scrolls the clipped image in
  83.                                 the appropriate direction.
  84.  
  85.            EXIT:  Returns to the main menu.
  86.  
  87.  
  88. DRAWING TOOLS
  89.  
  90.       FREEHAND DRAWING  Move the pointer inside the zoom area and
  91.                         click to plot a pixel.
  92.  
  93.       SPRAY PAINT  Randomly plot pixels until release of mouse   
  94.                    button.
  95.  
  96.       FLOOD PAINT  Fills an enclosed area with the current
  97.                    color. 
  98.  
  99.       ALL remaining tools work by selecting the starting point,
  100.       dragging the mouse, then releasing the mouse button.
  101.  
  102.  
  103. SELECTING COLORS
  104.  
  105. Simply select  the color of your choice.  In the 256 color mode
  106. you can scroll through the remaining colors by pressing on the up
  107. or down gadgets.
  108.  
  109.  
  110. PALETTE EDITING
  111.  
  112. Press the PAL gadget, select a color, use the RGB scrollers and
  113. gadgets to modify the color.
  114.  
  115.  
  116. ADDING GRAPHICS TO YOUR PROGRAMS
  117.  
  118.   One of the great features of Raster Master is its ability
  119.   create images compatible with the standard graphic libraries
  120.   included with Turbo C, QuickC, Turbo Pascal, and QuickBASIC.
  121.   Raster Master also supports additional libraries like Fastgraph
  122.   and TEGL Windows Toolkit.  Source code can be generated for    
  123.   images, palettes, and mouse pointers.
  124.  
  125.  
  126. 1.  RM RAW               - Raster Master's RAW format.
  127.  
  128. 2.  Palette              - Binary format containing RBG values.
  129. 3.  Palette (C)          - Source code in C for the palette.
  130. 4.  Palette (PAS)        - Source code in Pascal for the palette.
  131. 5.  Palette (BAS)        - Source code in BASIC for the palette.
  132.  
  133. 6.  TP/TC (Binary)       - Turbo C/Pascal binary image format to
  134.                            be displayed with the putimage        
  135.                            function.
  136.                      
  137.                            see Demo1.c for Turbo C
  138.                            see Demo1.pas for Turbo Pascal
  139.                            For 256 color images you must use the
  140.                            supplied SVGA256.bgi driver.
  141.  
  142.  
  143. 7.  TP Constants         - Turbo Pascal source code for format 6
  144.                            see Demo2.pas
  145.  
  146. 8.  TC Constants         - Turbo C source code for format 6
  147.                            see Demo2.c
  148.  
  149. 9.  QC/QB (Binary)       - QuickC/BASIC binary image format to be
  150.                            displayed with _putimage (QC) or PUT  
  151.                            (QB).
  152.                            See Demo3.c for QuickC
  153.                            See Demo1.bas for QuickBASIC
  154.  
  155.  
  156. 10. QC Constants         - QuickC source code for format 9
  157.                            see Demo4.c
  158.  
  159. 11. BASIC DATA           - QuickBASIC source code for format 9
  160.                            see Demo2.bas
  161.  
  162. 12. TEGL DEF             - TEGL Windows Toolkit text based HEX   
  163.                            format
  164.                            Refer to manual and TEGL code for DEF.
  165.  
  166.  
  167.  
  168. 13. PPR  Fastgraph       - Fastgraph Packed Pixel Run format. 16
  169.                            colors or less.
  170.  
  171. 14. SPR  Fastgraph       - Fastgraph Single Pixel Run format. max
  172.                            256 colors.
  173.  
  174. 15. FG PPR (C)           - C code for format 13
  175. 16. FG SPR (C)           - C code for format 14
  176. 17. FG PPR (PAS)         - Pascal code for format 13
  177. 18. FG SPR (PAS)         - Pascal code for format 14
  178. 19. FG PPR (BAS)         - Basic code for format 13
  179. 20. FG SPR (BAS)         - Basic code for format 14
  180.  
  181.  
  182.                           Refer to the Fastgraph user and        
  183.                           reference manuals.                     
  184.                           Use the included program xinfo.exe to  
  185.                           obtain the run count and width from    
  186.                           Raster Master created  SPR and PPR    
  187.                           files.
  188.  
  189.  
  190.  
  191.  
  192. 21. Mouse (C)            - C code for mouse image.
  193. 22. Mouse (PAS)          - Pascal code for mouse image.
  194. 23. Mouse (BAS)          - Basic code for mouse image
  195.  
  196.  
  197.  
  198.                           When saving in this format only the    
  199.                           first 16X16 pixels from the left top   
  200.                           corner will be saved. If the image is  
  201.                           clipped only the first 16X16
  202.                           pixels starting from the top left      
  203.                           corner of the clipped image will be    
  204.                           saved.
  205.  
  206.  
  207.                           The colors black, white, and dark blue
  208.                           are used to build the mouse image. Dark
  209.                           blue will be considered transparent.   
  210.                           Any other color is used to indicate that
  211.                           the screen pixel under the mouse image 
  212.                           will be inverted. 
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220. THE 'RAW' FORMAT
  221.  
  222.   Raster Master supports its own format for saving and retrieving
  223. files.  The format is broken up into three main parts. The
  224. Header, Palette, and Image portions.
  225.  
  226.                        ---  HEADER  ---
  227. Bytes
  228. -----
  229. 1 , 2 - Width of Image
  230. 3 , 4 - Height of Image
  231. 5 , 6 - Number of Colors - if 0 image does not contain a palette
  232.  
  233.                       ---  PALETTE  ---
  234.  
  235. 7 , 8 , 9  - Red, Green, Blue values of the first color.
  236.              The values will range from 0 to 63. Each additional
  237.              three bytes indicate the values of the next color.  
  238.              For an image that contains 16 colors the PALETTE    
  239.              size will be 48 bytes (3*16).  
  240.  
  241.                         ---  IMAGE ---
  242.  
  243. What ever follows after the palette is the actual image. The
  244. first byte following the palette will be the first pixel starting
  245. from th